---
title: S3
description: View S3 files
---

import { BlockInfoCard } from '@/components/ui/block-info-card'

<BlockInfoCard
  type="s3"
  color="#E0E0E0"
  icon={true}
  iconSvg={`<svg className="block-icon"
    
    
    preserveAspectRatio="xMidYMid"
    viewBox="0 0 256 310"
    
    xmlns="http://www.w3.org/2000/svg"
  >
    <path d="m20.624 53.686-20.624 10.314v181.02l20.624 10.254.124-.149v-201.297z" fill="#8c3123" />
    <path d="m131 229-110.376 26.274v-201.588l110.376 25.701z" fill="#e05243" />
    <path d="m81.178 187.866 46.818 5.96.294-.678.263-76.77-.557-.6-46.818 5.874z" fill="#8c3123" />
    <path
      d="m127.996 229.295 107.371 26.035.169-.269-.003-201.195-.17-.18-107.367 25.996z"
      fill="#8c3123"
    />
    <path d="m174.827 187.866-46.831 5.96v-78.048l46.831 5.874z" fill="#e05243" />
    <path d="m174.827 89.631-46.831 8.535-46.818-8.535 46.759-12.256z" fill="#5e1f18" />
    <path d="m174.827 219.801-46.831-8.591-46.818 8.591 46.761 13.053z" fill="#f2b0a9" />
    <path
      d="m81.178 89.631 46.818-11.586.379-.117v-77.615l-.379-.313-46.818 23.413z"
      fill="#8c3123"
    />
    <path d="m174.827 89.631-46.831-11.586v-78.045l46.831 23.413z" fill="#e05243" />
    <path
      d="m127.996 309.428-46.823-23.405v-66.217l46.823 11.582.689.783-.187 75.906z"
      fill="#8c3123"
    />
    <g fill="#e05243">
      <path d="m127.996 309.428 46.827-23.405v-66.217l-46.827 11.582z" />
      <path d="m235.367 53.686 20.633 10.314v181.02l-20.633 10.31z" />
    </g>
  </svg>`}
/>

## Usage Instructions

Retrieve and view files from Amazon S3 buckets using presigned URLs.

## Tools

### `s3_get_object`

Retrieve an object from an AWS S3 bucket

#### Input

| Parameter         | Type   | Required | Description                                                                      |
| ----------------- | ------ | -------- | -------------------------------------------------------------------------------- |
| `accessKeyId`     | string | Yes      | Your AWS Access Key ID                                                           |
| `secretAccessKey` | string | Yes      | Your AWS Secret Access Key                                                       |
| `s3Uri`           | string | Yes      | S3 Object URL \(e.g., https://bucket-name.s3.region.amazonaws.com/path/to/file\) |

#### Output

| Parameter      | Type   |
| -------------- | ------ |
| `metadata`     | string |
| `size`         | string |
| `name`         | string |
| `lastModified` | string |

## Block Configuration

### Input

| Parameter     | Type   | Required | Description                                  |
| ------------- | ------ | -------- | -------------------------------------------- |
| `accessKeyId` | string | Yes      | Access Key ID - Enter your AWS Access Key ID |

### Outputs

| Output       | Type   | Description              |
| ------------ | ------ | ------------------------ |
| `response`   | object | Output from response     |
| ↳ `url`      | string | url of the response      |
| ↳ `metadata` | json   | metadata of the response |

## Notes

- Category: `tools`
- Type: `s3`
